package com.ruoyi.kanban.mapper;

import java.util.List;
import java.util.Map;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.ruoyi.kanban.domain.KanbanOrder;

/**
 * 看板订单Mapper接口
 * 
 * @author ruoyi
 * @date 2025-01-18
 */
@Mapper
public interface KanbanOrderMapper extends BaseMapper<KanbanOrder> {

    /**
     * 查询看板订单列表
     * 
     * @param kanbanOrder 看板订单
     * @return 看板订单集合
     */
    List<KanbanOrder> selectKanbanOrderList(KanbanOrder kanbanOrder);

    /**
     * 根据看板编码查询看板订单
     * 
     * @param kanbanCode 看板编码
     * @return 看板订单
     */
    KanbanOrder selectKanbanOrderByCode(@Param("kanbanCode") String kanbanCode);

    /**
     * 根据框架协议ID查询看板订单列表
     * 
     * @param frameworkId 框架协议ID
     * @return 看板订单集合
     */
    List<KanbanOrder> selectKanbanOrderByFrameworkId(@Param("frameworkId") Long frameworkId);

    /**
     * 根据业务状态查询看板订单列表
     * 
     * @param businessStatus 业务状态
     * @return 看板订单集合
     */
    List<KanbanOrder> selectKanbanOrderByStatus(@Param("businessStatus") Integer businessStatus);

    /**
     * 统计看板订单数量
     * 
     * @param params 查询参数
     * @return 统计结果
     */
    Map<String, Object> selectKanbanOrderStatistics(@Param("params") Map<String, Object> params);

    /**
     * 批量更新看板订单状态
     * 
     * @param ids 订单ID列表
     * @param businessStatus 业务状态
     * @param updateBy 更新人
     * @return 更新数量
     */
    int updateKanbanOrderStatusBatch(@Param("ids") List<Long> ids, 
                                   @Param("businessStatus") Integer businessStatus,
                                   @Param("updateBy") String updateBy);
}